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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

The present document is part of a TS-family covering the 3^^ Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

TS 32.331 "Notification log Integration Reference Point (IRP): Requirements"; 

TS 32.332 "Notification log Integration Reference Point (IRP): Information Service (IS)" ; 

TS 32.333 " Notification log Integration Reference Point (IRP): Common Object Request Broker 

Architecture (CORE A) Solution Set (SS)". 

TS 32.334 "Notification log Integration Reference Point (IRP): Common Management Information Protocol 

(CMIP) Solution Set (SS)". 

TS 32.335 "Notification log Integration Reference Point (IRP): extensible Markup Language (XML) 

definitions". 

The present document is part of a TS-family, which describes the requirements and information model necessary for 
Telecommunications Management ^^. The TM principles and TM architecture are specified in 3GPP TS 32.101 [1] and 
3GPPTS 32.102 [2]. 

A communications system is composed of a multitude of Network Elements (NE) of various types and, typically, 
different vendors, which inter-operate in a co-ordinated manner in order to satisfy the network users' communication 
requirements. 

The occurrence of faults in an NE may cause deterioration or loss of this NE's function. Fault Management is the 
functional area, which allows the operator to detect the occurrence of faults in the network in real-time. Configuration 
Management and Performance Management are two more functional areas, which require the operator to be alerted to 
certain conditions in the network. 

A standard general-purpose mechanism for the management of logs containing selected notifications from the network 
is required to provide an ability to perform historical analysis on faults and conditions, which occurred in the network. 
The TS 32.33x-series, constituting the Notification log IRP, sets forth such a mechanism - and the present document 
contains the IS definition. 
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Scope 



The present document specifies the Information Service for the Notification Log Integration Reference Point (NL IRP) 
as it appHes to Itf-N. 

This IRP IS defines the semantics of operations (and their parameters) visible across the Itf-N in a protocol and 
technology neutral way. It does not define the syntax or encoding of the operations and their parameters. 



References 



The following documents contain provisions, which through reference in this text constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.101: "Telecommunication management; Principles and high level requirements". 

[2] 3GPP TS 32.102: "Telecommunication management; Architecture". 

[3] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP) : Information Service (IS)". 

[4] 3GPP TS 32.622: "Telecommunication management; Configuration Management (CM); Generic 

network resources Integration Reference Point (IRP): Network Resource Model (NRM)". 

[5] 3GPP TS 32.1 1 1-2: "Telecommunication management; Fault Management; Alarm Integration 

Reference Point (IRP): Information Service (IS)". 

[6] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Information Service (IS)". 

[7] 3GPP TS 32.331: "Telecommunication management; Notification Log Integration Reference Point 

(IRP): Requirements". 

[8] 3GPP TS 32.342 "Telecommunication management; File Transfer (FT) Integration Reference 

Point (IRP): Information Service (IS)". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in 3GPP TS 32.101 [1], 3GPP TS 32.102 [2], 
3GPP TS 32.111-2 [5] and 3GPP TS 32.331 [7] apply. 

notification category: it refers to the set of notifications of one 3 GPP IRP Information Service specification 

A Notification Category is identified by the name of the IRP specification and the IRP specification version number. 



ETSI 



3GPP TS 32.332 version 6.0.0 Release 6 



ETSI TS 132 332 V6.0.0 (2004-12) 



3.2 



Abbreviations 



For the purposes of the present document, the following abbreviations apply: 



DN 

EM 

FT 

IOC 

IRP 

M 

NE 

NL 

NM 

O 

TS 

UML 



Distinguished Name 
Element Manager 
File Transfer 
Information Object Class 
Integration Reference Point 
Mandatory 
Network Element 
Notification Log 
Network Manager 
Optional 

Technical Specification 
Unified Modelling Language 



4 System overview 

4.1 System context 

Figures 4.1 and 4.2 identify system contexts of the IRP defined by the present specification in terms of its 
implementation called IRP Agent and the user of the IRP Agent, called IRPManager. For a definition of IRPManager 
and IRPAgent, see 3GPP TS 32.102 [2]. 

The IRPAgent implements and supports this IRP. The IRPAgent can reside in an Element Manager (EM - see figure 
4.1) or a Network Element (NE - see figure 4.2). In the former case, the interfaces (represented by a thick dotted line) 
between the EM and the NEs are not the subject of this IRP. 

An IRPManager using this IRP shall choose one of the two System Contexts defined here, for each NE. For instance, if 
an EM is responsible for managing a number of NEs, the NM shall access this IRP through the EM and not directly to 
those NEs. For another IRP though, the System Context may be different. 

By observing the interaction across this IRP, one cannot deduce if EM and NE are integrated in a single system or if 
they run in separate systems. 
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Figure 4.1 : System Context A 
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Figure 4.2: System Context B 



4.2 Compliance rules 



For general definitions of compliance rules related to qualifiers (Mandatory/Optional/Conditional) for operations, 
notifications and parameters (of operations and notifications) please refer to 3GPP TS 32.102 [2]. 



5 Information Object Classes 

5.1 Information entities imported and local labels 



Label reference 


Local label 


3GPP TS 32.622 [4], information object class, Top 


Top 


3GPP TS 32.312 [6], information object class, ManagedGenericIRP 


ManagedGenericIRP 


3GPP TS 32.342 [8], information object class, FileTransferlRP 


FileTransferlRP 


3GPP TS 32.302 [3], information object class, NotificationIRP 


NotificationIRP 


3GPP TS 32.302 [3], information object class, NotificationlRPNotification 


NotificationlRPNotification 



5.2 Class diagram 

5.2.1 Attributes and relationships 

This subclause introduces the set of Information Object Classes (lOCs) that encapsulate information within the 
IRPAgent. The intent is to identify the information required for NL IRP operations and notification. This subclause 
provides the overview of all support object classes in UML. Subsequent subclauses provide more detailed specification 
of various aspects of these support object classes. 
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«lnformationObjectClass» 
NLIRP 



+ maxLogs 



«names» 



\[/0..* 



«lnfornnationObjectClass» 
Log 



+ logSubscriptionld 

+ loggingEndTime 

+ maxSize 

+ currentSize 

+ creationTime 

+ logState 

+ logRecordCount 

+ notificationCategories 

+ filter 

+ logFullAction 

+ occupancyLevels 

% logManagerToken 



+log4 1 

relation-log-logRecord 
+logRecord\i/ 0..* 



«lnformationObjectClass» 
Log Record 



+ logRecordld 

+ logRecordContent 



relation-logRecord-notification 

o >^ 

1 1 

+logRecord +notification 



NotificationlRPNotifi cation 

(from TS32.302) 



+ notificationid 
+ eventTime 
+ system DN 
+ notificationType 



Figure 5.1 : Information Object Class UML Diagram 

To change: change logid, add logrecordcontent, remove logrecordsource. 
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5.2.2 Inheritance 



ManagedGenericIRP 
(from TS32.312) 



A 



«lnformationObjectClass» 
NLIRP 



+ maxLogs 



«lnformationObjectClass» 
Top 

(from TS32.622) 



+ objectClass 
+ object In stance 



«lnformationObjectClass» 
Log 



+ logSubscriptionld 

+ loggingEndTime 

+ maxSize 

+ currents! ze 

+ creationTime 

+ logState 

+ logRecordCount 

+ notificationCategories 

+ filter 

+ logFullAction 

+ occupancyLevels 

% logManagerToken 



A 



«lnformationObjectClass» 
Log Record 

+ logRecordld 

+ logRecordContent 



Figure 5.2: Information Object Class Inheritance UML Diagram 

5.3 Information Object Class definitions 

5.3.1 NLIRP 



5.3.1.1 



Definition 



LogIRP is the representation of the notification log management capabihties specified by the present document. This 
IOC inherits from ManagedGenericIRP IOC specified in 3GPP TS 32.312 [6]. 



5.3.1.2 



Attributes 



Attribute name 


Visibility 


Support 
Qualifier 


Read 
Qualifier 


Write 
Qualifier 


maxLogs 


+ 





M 


- 
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5.3.2 Log 



5.3.2.1 Definition 

The Log IOC is the representation of a Notification Log. 



5.3.2.2 



Attributes 



Attribute name 


Visibility 


Support 
Qualifier 


Read 
Qualifier 


Write 
Qualifier 


logSub script ion Id 


+ 


M 


M 


- 


loggingEndTime 


+ 





M 


- 


logManager Token 


% 





- 


- 


maxSize 


+ 





M 


- 


currentSize 


+ 





M 


- 


creationTime 


+ 





M 


- 


logState 


+ 


M 


M 


- 


logRecordCount 


+ 





M 


- 


notif icationCategories 


+ 





M 


- 


filter 


+ 





M 


- 


logFullAction 


+ 


M 


M 


- 


occupancyLevels 


+ 


M 


M 


- 



5.3.2.3 



State diagram 



occupancyLevel Changed 



\^ 1 



startLog 



-^ 



logWrapping 



logFull[ logFullAction==wrap ] 



stopLog II logLifeTimeExpired 



Jl 



lOQQ'I^Q StopLog II logLifeTimeExpired 



-^ 



Stopped 



logFull[ logFullAction==iialt ] 



V 



A 



logNotFull / notifyLoggingResumedO 



logHalted 



StopLog II logLifeTimeExpired 



Figure 5.3: State Diagram for Notification Log 

The disposition of a log that has been stopped, that is, whether the log remains visible across the Itf-N, is left as vendor 
specific functionality. The time of the deletion of logs is vendor specific. 

5.3.3 LogRecord 
5.3.3.1 Definition 

The LogRecord IOC is the representation of an individual Notification Log Record. 
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5.3.3.2 



Attributes 



Attribute name 


Visibility 


Support 
Qualifier 


Read 
Qualifier 


Write 
Qualifier 


logRecordld 


+ 


M 


M 


- 


LogRecordContent 


+ 





M 


- 



5.4 Information relationship definitions 

5.4.1 Relation-nLIRP-log (M) 
5.4.1.1 Definition 

This represents the relationship between NLIRP and the Log. 



5.4.1.2 



Role 



Name 


Definition 


nLIRP 


It represents the nlirp. 


log 


It represents the Log. 



5.4.1.3 



Constraint 



Name 


Definition 


uniqueLogSubscriptionId 


The log subscription id must be unique amongst all logs managed by a given NL IRP 
instance. 


uniqueLoglVlanagerToken 


The log manager token must be unique amongst all managers and logs utilizing logging 
services from a given NL IRP instance. 



5.4.2 Relation-log-logRecord (M) 

5.4.2.1 Definition 

This represents the relationship between Log and the LogRecord. 

5.4.2.2 Role 



Name 


Definition 


log 


It represents the Log. 


logRecord 


It represents the LogRecord. 



5.4.2.3 



Constraint 



Name 


Definition 


uniqueLogRecordId 


The log record id must be unique amongst all logs records within a given log. 



5.4.3 Relation-logRecord-notificationlRPNotification (M) 



5.4.3.1 



Definition 



This represents the relationship between LogRecord and the notification header represented by 

Notif icationlRPNotif ication. 
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5.4.3.2 



Role 



Name 


Definition 


logRecord 


It represents the LogRecord. 


notification 


It represents the Notif icationlRPNotif ication. 



5.4.3.3 



Constraint 



Name 


Definition 


logRecordldRelatesNotificationld 


Within a given log, there is a one-to-one relationship between Notification Id and Log 
Id (as each notification can only be recorded once). 
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5.5 



Information attribute definition 



5.5.1 Definition and legal values 



Attribute Name 


Definition 


Legal Values 


creationTime 


The time when the log is created. 


YYYYMMDDhhmmss 


currentSize 


This attribute provides the number of bytes 
currently utilized by a given log. When taken in 
conjunction with maxSize, the amount of space 
remaining in the log can be determined. 


Either: 

• zero 

• a positive whole number, 


filter 


It specifies a filter constraint that IRPAgent shall 
use to filter notification of the category specified in 
notif icationCategories parameter. 
Support of time based filter is mandatory. Support 
of other filter constraints is optional. 


Filter constraint grammar is SS 
dependent 


logFullAction 


Indicate the action that will be taken by this 
instance of NLIRP when the 
Log. maxSize has been reached. 


An ENUM that can have one of the 
following values: 

• wrap: The oldest LogRecord(s) in 
the Log, based on the log time, will be 
deleted to free resources for the logging 
of new LogRecord(s). 

• halt: No more LogRecord(s) will be 
logged and all incoming events are 
discarded. LogRecord/s already in the 
Log will be retained. 


loggingEnclTime 


Defines the date and time when the log stops 
logging. 


If log is created by IRPManager: 
^^ value provided by the IRP 
Manager - the IRP Agent may 
reject the value provided by the 
IRP Manager in case this value 
is excessive 
*. in case no value is provided by 
the IRP Manager then this 
value is set by the IRP Agent. 

If log is created by IRPAgent: 

4 value indicates date and time 

or 
4^ value is expressed as 
'indefinite'. 


logManagerToken 


This attribute contains the token of a manager 
utilizing logging services from a given NL IRP 
instance, assigned by the IRPAgent. 


The value of this attribute must be 
unique amongst all managers and logs 
utilizing logging services from the given 
NL IRP instance. 


logRecordContent 


The notification information of a log record, 
excluding the notification header information. 


The content format varies depending on 
the type of the notification. 


logRecordCount 


The number of log records currently logged within 
a given log. 


positive whole number, including zero 


logRecordld 


This attribute contains the id of a log record within 
a given log, assigned by the IRPAgent. 


The value of this attribute must be 
unique amongst all log record contained 
by a given log. 


logState 


Provides an indication of the current state of a 
specific log 


An ENUM that can have one of the 
following values: 

• logging 

• logFull 

• stopped 


logSubscriptionld 


This attribute contains the id of a log subscription 
within a given NL IRP instance, assigned by the 
IRPAgent. 


The value of this attribute must be 
unique amongst all log subscriptions 
managed by a given NL IRP instance. 


maxLogs 


Defines the maximum number of logs that can be 
supported by a given Notification Log IRP, 
assigned by the IRPAgent. 


Non-zero, positive whole number 


maxSize 


This attribute defines the maximum number of 
bytes that may be utilized by a given log, assigned 
by the IRPAgent. 


Either: 

• Non-zero, positive whole number 

• Zero indicates no limit on the 
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Attribute Name 


Definition 


Legal Values 






number of records is set by the 
IRPAgent (log full handling will 
provide limitation information) 


notificationCategories 


Specifies the notification categories that can be 
recorded within a given log - SET OF (name of 
IRP, version of IRP) 


It identifies one or more Notification 
Category (see also Definition in 
subclause 3.1) 


occupancyLevels 


Case Log.logFullAction == "halt" and Log.maxSize 

is non-zero: 

•4 this attribute contains a list of 3 values 
fixed (determined by the IRPAgent and 
never changed) of percentage, of 
Log.maxLog 
m the NLIRP will generate 
notifyOccupancyLevel to alert 
IRPManagers about the Log capacity 
currently used. 

Case Log.logFullAction == "wrap": 

J. this attribute contains 1 value fixed 
(determined by the IRPAgent and never 
changed) of percentage of Log.maxLog 
^ the NLIRP will generate 

notifyOccupancyLevel to alert 
IRPManagers that the specified 
percentage of the capacity has been 
written to the wrapping Log. 


Case of "halt": a set of 3 values. 
Case of "wrap": 1 value. 



5.5.2 Constraints 



Name 


Definition 


inv lastModifiedTime 


Time indicated shall be greater than or equal to creationTime. 


inv logRecordCount 


Number indicated shall be less than or equal to maxSize 
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6 Interface definition 

6.1 Class diagram 



«lnterface» 
NLIRPOperations_1 



NLIRPOperations_1 shall support either ^ 
operation ex port Log Records or operation 
getLogRecords as mandatory. 



+ subscribe Logo 
+ u n subscribe Log 
«optional» + exportLogRecordsQ 
«optional» + getLogRecordsQ 



«lnterface» 
NLIRPOperations_2 



+ getLogSubscriptionldsQ 
+ getLogSubscriptionStatus() 



/\ 
«may realize» 



«lnformationObjectClass» 
NLIRP 
+ maxLogs 



^ 



«Notification» 
NLIRPNotifications 1 



+ notifyLogSubscribedQ 
+ notifyLogUnsubscribedQ 



«may use» 



«agent-internal-usage» 



JL 



«agent-interna -usage» 



«Notification» 
NLIRPNotifications 2 



+ notifyOccupancyLevelCrossedQ 
«optional» + notifiyLoggingResumedQ 



FileTransferlRP 
(from TS32.342) 



«agent-internal-usage» 



JL 



«lnformationObjectClass» 
NotificationIRP 
(from TS32.302) 



Figure 6.1 Class diagram 

Note: NLIRPOperations_l shall support either operation exportLogRecords or operation getLogRecords as mandatory. 

6.2 Generic rules 

Rule 1: Each operation with at least one input parameter supports a pre-condition valid_input_parameter which 

indicates that all input parameters shall be valid with regards to their information type. Additionally, each 
such operation supports an exception operation_failed_invalid_input_parameter which is raised when pre- 
condition valid_input_parameter is false. The exception has the same entry and exit state. 

Rule 2: Each operation with at least one optional input parameter supports a set of pre-conditions 

supported_optional_input_parameter_xxx where "xxx" is the name of the optional input parameter and 
the pre-condition indicates that the operation supports the named optional input parameter. Additionally, 
each such operation supports an exception operation_failed_unsupported_optional_input_parameter_xxx 
which is raised when (a) the pre-condition supported_optional_input_parameter_xxx is false and (b) the 
named optional input parameter is carrying information. The exception has the same entry and exit state. 
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Rule 3: Each operation shall support a generic exception operation_failed_intemal_problem which is raised when 
an internal problem occurs and that the operation cannot be completed. The exception has the same entry 
and exit state. 



6.3 NLIRPOperations_1 Interface (M) 
6.3.1 Operation subscribeLog (M) 



6.3.1.1 



Definition 



Using this operation, an IRPManager is initiating the logging of notifications. Resulting from this operation an 
IRP Agent shall start logging of notifications and, if necessary, also create an associated log. 



6.3.1.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


logSubscriptionld 


M 


Log. logSubscriptionld 


See subclause 5.5.1 

If empty, then IRPAgent shall create a new log and return the 
logSubscriptionld as output parameter. However not all 
IRPAgents will provide this capability, i.e. IRPManager must 
provide an existing logSubscriptionld. 


loggingEndTime 





Log. loggingEndTime 


See subclause 5.5.1 


notificationCategories 





Log. 
notificationCategories 


See subclause 5.5.1 ; if notificationCategories is absent than 
all notifications are logged 


filter 





Log.ntfFilter 

Filter constraint 
grammar is SS 
dependent 


See subclause 5.5.1 ; if this parameter is absent, then no filter 
constraint shall be applied. 



6.3.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


logSubscriptionld 


M 


Log. logSubscriptionld 


See subclause 5.5.1 

This parameter contains either 

•- the logSubscriptionld of the log created 

resulting from this operation or 
4 the value of the input parameter 
logSubscriptionld. 


logManagerToken 





Log. logManagerToken 


See subclause 5.5.1 

See also comment 6.3.2.2. 

Note: Security Management IRP may provide capabilities 

that make this parameter redundant. 


loggingEndTime 





Log. loggingEndTime 


See subclause 5.5.1 

If supported by the Log IOC (5.3.2) and not already 
provided by the IRP Manager then the output of this 
operation must support this parameter. 


status 


M 


ENUM (OperationSucceeded, 
OperationFailed) 


If loggingEndTime is valid and notificationCategoriesis 
valid or absent, status = OperationSucceeded. 
If operationjailed is true, status = OperationFailed. 
If loggingEndTime exzessive, status = OperationFailed. 



6.3.1.4 



Pre-condition 



logsNotMaxed 



Assertion Name 


Definition 


logsNotMaxed 


The number of logs is less than the maximum number of logs allowed. 
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6.3.1.5 



Post-condition 



logStarted 



Assertion Name 



Definition 



logStarted 



A log is started with the specified characteristics (lifetime and notificationCategories). 



6.3.1.6 



Exceptions 



Exception Name 


Definition 


logSubscriptionld_required 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 


maxLogs_reached 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 


operationjailed 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



6.3.2 Operation unsubscribeLog (M) 



6.3.2.1 



Definition 



Using this operation, the IRPManager that started a specific log is able to stop this log via unsubscribing. Note stopping 
a log implies that the log becomes invisible across Itf-N, independent from the loggingEndTime; therefore the 
IRPManager should retrieve log information of interest before using this unsubscribeLog operation, e.g. through 

the expo rtLogRe cords operation. 

The disposition of a log that has been stopped, that is, whether the log remains visible across the Itf-N, is left as vendor 
specific functionality. The time of the deletion of logs is vendor specific. 

In consideration of a multi-mamager environment, the log can only be stopped by the creating IRPManager if this 
IRPManager provided a related token while initiating subscribeLog. 



6.3.2.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


logSubscriptionld 


M 


Log. logSubscriptionld 


See subclause 5.5.1 


logManagerToken 





Log. logManagerToken 


See subclause 5.5.1 

If subscribeLog returned a logManagerToken for a log with 

logSubscriptionld='X', then logManagerToken must be provided as 

input parameter of this operation to successfully stop log with 

logSubscriptionld='X'. 

If subscribeLogdid not return a logManagerToken for a log with 
logSubscriptionld='X', then logManagerToken must contain NULL 
value to successfully stop log with logSubscriptionld='X'. 



6.3.2.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (OperationSucceeded, 
OperationFailed) 


If logSubscriptionld is valid and logManagerToken (if 
supported) is matching, status = OperationSucceeded. 
If operationjailed is true, status = OperationFailed. 
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6.3.2.4 Pre-condition 

There are no pre-conditions, other than those estabHshed by the generic rules (see subclause 6.2). 

6.3.2.5 Post-condition 

logStopped 



Assertion Name 


Definition 


logStopped 


The specified log is stopped. 



6.3.2.6 



Exceptions 



Exception Name 


Definition 


operationjailed 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



6.3.3 Operation exportLog Records (O) 

Support for this operations is mandatory if getLogRecords is not supported. 



6.3.3.1 



Definition 



Using this operation, an IRPManager can initiate export of all or part of a log into a file. This file than is being 
transferred to the IRPManager using the File Transfer IRP (note also that the FT IRP is providing the file location to the 
IRP Manger). 



6.3.3.2 



Input parameters 



Parameter Name 


Quali 
fier 


Information type 


Comment 


logSubscriptionld 


M 


Log. logSubscriptionld 


See subclause 5.5.1 


notificationCategories 





Log. notificationCategories 


See subclause 5.5.1 


filter 





Log. filterLog. filter 


See subclause 5.5.1 



6.3.3.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


status 


M 


ENUM (OperationSucceeded, 
NoMatchingLogRecordFound, 
OperationFailed) 


If input parameters are valid and operation was 

successful, status = OperationSucceeded. 

If input parameters are valid and operation was 

successful but no matching log records are found, 

status = NoMatchingLogRecordFound. 

If operation failed is true, status = OperationFailed. 
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6.3.3.4 Pre-condition 

There are no pre-conditions, other than those estabHshed by the generic rules (see subclause 6.2). 

6.3.3.5 Post-condition 

logRe cords Exported 



Assertion Name 


Definition 


logRecordsExported 


The specified log records have been exported as requested. In case the log is empty or in 
case that all the log records do not satisfy the criteria of input parameters 
notificationCategories and filter, this post-condition is true. 



6.3.3.6 



Exceptions 



Exception Name 


Definition 


exportFailed 


The IRPAgent was unable to export the specified records. 


operationjailed 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



6.3.4 Operation getLog Records (O) 

Support for this operations is mandatory if exportLogRecords is not supported. 

6.3.4.1 Definition 

Using this operation, an IRPManager can retrieve one or more log records from a certain log. 

Note that this operation might be preferred for retrieval of small amounts of log records, while operation 
exportLogRecords might be prefered for retrieval of medium to large amounts of log records, as providing a more 
efficient bulk transfer mechanism. 



6.3.4.2 



Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


logSubscriptionId 


M 


Log. logSubscriptionId 


See subclause 5.5.1 


notificationCategories 





Log. notificationCategories 


See subclause 5.5.1 


filter 





Log.filter 


See subclause 5.5.1 



6.3.4.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


getLogRecordsResult 


M 


List of logRecord's 


List of logRecords; each entry of the list holds all 
supported attributes of IOC LogRecord (see 5.3.3.2). 


Status 


M 


ENUM (OperationSucceeded, 
OperationFailed) 


If logSubscriptionId is valid and (logRecordldList is 

empty or logRecordldList contains valid Id's), status = 

OperationSucceeded. 

If operation failed is true, status = OperationFailed. 
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6.3.4.4 Pre-condition 

There are no pre-conditions, other than those estabHshed by the generic rules (see subclause 6.2). 

6.3.4.5 Post-condition 

logRecordsRetrieved 



Assertion Name 


Definition 


logRecordsRetrieved 


The specified log records have been retrieved as requested. If the log is empty or all the log 
records do not satisfy the criteria of input parameters notificationCategories and filter, this 
post-condition is true. 



6.3.4.6 



Exceptions 



Exception Name 


Definition 


operationjailed 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



6.4 NLIRPOperations_2 Interface (O) 

6.4.1 Operation getLogSubscriptionlds (M) 

6.4.1.1 Definition 

Using this operation, an IRPManager can query the NL IRP for all available log subscriptions. 

6.4.1.2 Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


- 


- 


- 


- 



6.4.1.3 



Output parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


logSubscriptionlds 


M 


List of logSubscriptionld's 


See subclause 5.5.1 & 6.4.1 .2 
Note: empty list is a valid value 


status 


M 


ENUM (OperationSucceeded, 
OperationFailed) 


If operation is successful, status = 

OperationSucceeded. 

If operationjailed is true, status = 

OperationFailed. 
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6.4.1.4 Pre-condition 

There are no pre-conditions, other than those estabHshed by the generic rules (see subclause 6.2). 

6.4.1.5 Post-condition 

There are no post-conditions. Querying of log subscription Id"s does not result in any changes within the IRP Agent. 

6.4.1.6 Exceptions 



Exception Name 


Definition 


operationjailed 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 



6.4.2 Operation getLogSubscriptionStatus (M) 

6.4.2.1 Definition 

Using this operation, an IRPManager can query the NL IRP for available log status information of an individual log 

6.4.2.2 Input parameters 



Parameter Name 


Qualifier 


Information type 


Comment 


logSubscriptionld 


M 


Log. logSubscriptionld 


See subclause 5.5.1 



6.4.2.3 



Output parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


logAttributeList 


M 


Attribute list of related Log IOC 


List of all supported attributes of IOC Log (see 
subclause 5.3.2.2). 


status 


M 


ENUM (OperationSucceeded, 
OperationFailed) 


If logSubscriptionld is valid status = 

OperationSucceeded. 

If operationjailed is true, status = OperationFailed. 



6.4.2.4 Pre-condition 

There are no pre-conditions, other than those estabHshed by the generic rules (see subclause 6.2). 

6.4.2.5 Post-condition 

There are no post-conditions. Querying of log attributes does not result in any changes within the IRP Agent. 

6.4.2.6 Exceptions 



Exception Name 


Definition 


operationjailed 


Condition: Pre-condition is true AND post-condition is false. 
Returned Information: The output parameter status. 
Exit state: Entry state. 
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6.5 NLIRPNotifications_1 Interface (M) 
6.5.1 Notification notifyLogSubscribed (M) 



6.5.1.1 



Definition 



Using this notification, an IRP Agent informs all subscribed IRPManagers that a log subscription has been succesfully 
initiated. 



6.5.1.2 



Input Parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M 




This parameter and objectlnstance together carry the 
semantics of the DN of Log. Notification header - see 3GPP 
TS 32.302 [31 


objectlnstance 


M 




This parameter and objectClass together carry the semantics 
of the DN of Log. Notification header - see 3GPP TS 
32.302 [31 


notificationid 


M 


— 


Notification header - see 3GPP TS 32.302 [31 


eventTime 


M 


- 


Notification header - see 3GPP TS 32.302 [31 


notificationType 


M 


"notifyLogSubscribed" 


Notification header - see 3GPP TS 32.302 [31 


system DN 


C 


IRP Agent . systemDN. 


It carries the DN of the irp Agent that emits this notification. 
Notification header - see 3GPP TS 32.302 [31 


logSubscriptionld 


M,N 


Log. logSubscriptionld 


See subclause 5.5.1 


loggingEndTime 


0,N 


Log. loggingEndTime 


See subclause 5.5.1 


notificationCategories 


0,N 


Log. notificationCategories 


See subclause 5.5.1 ; if absent than all notifications are being 
logged 


filter 


0,N 


Log.filter 


See subclause 5.5.1 



6.5.1.3 Triggering Event 

6.5.1.3.1 From-state 

subscribeLog 



Assertion Name 



Definition 



subscribeLog 



An IRPManager requests that a new log be started. 



6.5.1.3.2 To-State 

logStarted 



Assertion Name 



Definition 



logStarted 



The NL IRP has started the requested logging activity. 



6.5.2 Notification notifyLogUnsubscribed (M) 
6.5.2.1 Definition 

Using this notification, an IRP Agent informs all subscribed IRPManager that a log subscription has stopped. 
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6.5.2.2 



Input Parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M 


-- 


This parameter and objectlnstance together carry the semantics of 
the DN of Log. Notification header - see 3GPP TS 32.302 [3] 


objectlnstance 


M 


— 


This parameter and objectClass together carry the semantics of the 
DN of Log. Notification header - see 3GPP TS 32.302 [3] 


notificationid 


M 


— 


Notification header - see 3GPP TS 32.302 [3] 


eventTime 


M 


- 


Notification header - see 3GPP TS 32.302 [3] 


notificationType 


M 


"notifyLogUnsubscribed" 


Notification header - see 3GPP TS 32.302 [3] 


system DN 


C 


IRP Agent . systemDN. 


It carries the DN of the irp Agent that emits this notification. 
Notification header - see 3GPP TS 32.302 [3] 


logSubscriptionld 


M,N 


Log. logSubscriptionld 


See subclause 5.5.1 



6.5.2.3 



Triggering Event 



6.5.2.3.1 From-state 

unsubscribeLog OR loggingEndTimeReached 



Assertion Name 


Definition 


unsubscribeLog 


The IRPManager that started the log requests that the log be unsubscribed. 


loggingEndTimeReached 


The logging end timespecified for the log in subscribeLog has been reached. 



6.5.2.3.2 

logStopped 



To-State 



Assertion Name 


Definition 


logStopped 


The logging activity has stopped. 



6.6 NLIRPNotifications_2 Interface (O) 
6.6.1 Notification notifyOccupancyLevelCrossed (M) 



6.6.1.1 



Definition 



Using this notification, an IRP Agent informs all subscribed IRPManagers about the occupancy level of a certain log 
according with levels defined in 5.1.1 (in addition also the log full action type of this NLIRP instance is being provided 
for context purposes). 
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6.6.1.2 



Input Parameters 



Parameter Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M 




This parameter and objectlnstance together carry 
the semantics of the DN of Log. Notification header 
- see 3GPP TS 32.302 [3] 


objectlnstance 


M 




This parameter and objectClass together carry the 
semantics of the DN of Log. Notification header - 
see 3GPP TS 32.302 [3] 


notificationid 


M 


— 


Notification header - see 3GPP TS 32.302 [3] 


eventTime 


M 


- 


Notification header - see 3GPP TS 32.302 [3] 


notificationType 


M 


"notifyOccupancyLevelCrossed" 


Notification header - see 3GPP TS 32.302 [3] 


system DN 


C 


IRP Agent . systemDN. 


It carries the DN of the irp Agent that emits this 
notification. Notification header - see 
3GPP TS 32.302 [3] 


logSubscriptionld 


M,Y 


Log. logSubscriptionld 


See subclause 5.1.1 


currentOccupancyLevel 


M,N 


Log.currentSize/ 
Log.currentSize*100 


See subclause 5.1.1 


logFullAction 


0,N 


Log. logFullAction 


See subclause 5.1.1 



6.6.1.3 



Triggering Event 



6.6.1.3.1 From-state 

logFull OR occupanceLevelCrossed 



Assertion Name 


Definition 


logFull 


The log is full, that is, the number of log records contained within the log has exceeded the 
maximum number of log records that was established at log startup (log capacity has reached 
100%). 


occupancyLevelCrossed 


The number of log records within the log has crossed one of the threshold boundaries (see 
5.1.1 log.occupancyLevel). 



6.6.1.3.2 



To-state 



logWrapping OR (logHalted OR logging) 



Assertion 
Name 


Definition 


logWrapping 


Applicable for case Log.logFullAction="wrap": The number of log records within the log has exceeded the 
maximum number of allowed log records (100 % capacity has been crossed). The logging of new records 
will cause the oldest records within the log to be deleted and replaced (first in, first out). The deletion of 
records may occur in a block, such that the log transitions back to the 'started' state prior to any new 
records being written. 


logHalted 


Applicable for case Log.logFullAction="halt": The number of log records within the log has exceeded the 
maximum number of allowed log records (100 % capacity has been crossed). The logging of new records 
will be discontinued until the deletion of records has occurred (deletion of records is outside the scope of 
this IRP). 


logging 


Applicable for case Log.logFullAction="halt": The number of log records within the log is below the 
maximum number of allowed records. The generation of the notification is done to inform the subscribed 
IRPManagers that the log is filling up. 



6.6.2 Notification notifyLoggingResumed (O) 



6.6.2.1 



Definition 



Using this notification, an IRP Agent informs all subscribed IRPManagers that the amount of data within a given log has 
been reduced, allowing logging to resume continue (according to the information provided when the log was created). 
Note that this notification only applies to Log. logFull Action == "halt". 
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6.6.2.2 



Input Parameters 



Parameter 
Name 


Qualifier 


Matching Information 


Comment 


objectClass 


M 


~ 


This parameter and objectlnstance together carry the semantics of 
the DN of Log. Notification header - see 3GPP TS 32.302 [3] 


objectlnstance 


M 


— 


This parameter and objectClass together carry the semantics of the 
DN of Log. Notification header - see 3GPP TS 32.302 [3] 


notificationid 


M 


— 


Notification header - see 3GPP TS 32.302 [3] 


eventTime 


M 


- 


Notification header - see 3GPP TS 32.302 [3] 


notificationType 


M 


"notifyLoggingResumed" 


Notification header - see 3GPP TS 32.302 [3] 


system DN 


C 


IRP Agent . systemDN. 


It carries the DN of the irp Agent that emits this notification. 
Notification header - see 3GPP TS 32.302 [3] 


logSubscriptionld 


M,Y 


Log. logSubscriptionld 


See subclause 5.1.1 



6.6.2.3 



Triggering Event 



6.6.2.3.1 

logFull 



From-state 



Assertion Name 


Definition 


logHalted 


The log is full, that is, the number of log records contained within the log has exceeded the 
maximum number of log records that was established at log startup (log capacity has reached 
100 % and Log.logFullAction="halt"). 


occupancyLevelCrossed 


The number of log records within the log has crossed one of the threshold boundaries (see 
5.1.1 log.occupancyLevel ). 



6.6.2.3.2 



To-state 



Assertion 
Name 



Definition 



logging 



The number of log records within the log is below the maximum number of allowed records. The 
generation of the notification is done to inform the subscribed IRPManagers that the log is filling up. 
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